---
title: Quick Start
description: Get up and running with a new Motia project in just a few seconds.
---
<Steps>

<Step>
### 1. Create Your Project

Use `npx` to create a new Motia project. This single command will scaffold a new application and install all necessary dependencies.

```bash
npx motia@latest create
```

The installer will guide you through a few questions to set up your project, including choosing a template. Once it's done, you will have a new project directory ready to go.

<Callout type="info">
**Quick Start with a Specific Template**

If you already know which template you want, you can skip the interactive prompts:

```bash
# All languages (TypeScript/JavaScript + Python)
npx motia@latest create my-app --template starter-multilang

# TypeScript only
npx motia@latest create my-app --template starter-typescript

# JavaScript only
npx motia@latest create my-app --template starter-javascript

# Python only
npx motia@latest create my-app --template starter-python
```

See the [CLI documentation](/docs/development-guide/cli#create) for all available templates.
</Callout>

<Callout type="info">
**Using Your Own Redis?**

If you already have Redis running or prefer to use an external Redis instance, use the `--skip-redis` flag:

```bash
npx motia@latest create my-app --skip-redis
```

See [CLI documentation](/docs/development-guide/cli#create) for more details.
</Callout>

</Step>

<Step>
### 2. Start the Development Server

Navigate into your new project directory and start the Motia development server.

```bash
cd <your-project-name> # If you've created a new folder for the project, navigate into it

npx motia dev
```

![run dev command](/docs-images/motia-terminal.gif)

<Callout>
The `create` command uses `npm` by default. If you chose a different package manager during setup, use `pnpm dev`, `yarn dev`, or `bun dev`.
</Callout>

This command starts the Motia runtime and the Workbench, a powerful UI for developing and debugging your workflows. By default, it's available at [`http://localhost:3000`](http://localhost:3000).

</Step>

<Step>
### 3. Run Your First Flow

The starter project comes with a pre-built `basic-tutorial` flow. Let's run it.

1.  **Open the Workbench** in your browser at [`http://localhost:3000`](http://localhost:3000).
2.  **Click the `Tutorial`** button on the top right of the workbench.
3.  **Complete the `Tutorial`** to get an understanding of the basics of Motia and using the Workbench.

![run starter app](/docs-images/motia-build-your-app.gif)

</Step>

<Step>
### Next Steps

Congratulations! You've successfully ran, and observed your first Motia workflow.

- Build your first application from scratch, follow our **[Build Your First Motia App](/docs/getting-started/build-your-first-motia-app)** guide.
- To learn about Motia, dive into our **[Core Concepts](/docs/concepts/overview)**.

</Step>
</Steps>
